Skip to content

Added community guide links for Azure Static Web Apps hosting#92

Open
barcar wants to merge 3 commits intozensical:masterfrom
barcar:azureswa-hosting
Open

Added community guide links for Azure Static Web Apps hosting#92
barcar wants to merge 3 commits intozensical:masterfrom
barcar:azureswa-hosting

Conversation

@barcar
Copy link
Copy Markdown

@barcar barcar commented Mar 29, 2026

Per guidance, added Other section to publish-your-site with links to 2 community guides:

  • Azure Static Web Apps with GitHub
  • Azure Static Web Apps with Azure DevOps

barcar added 3 commits March 29, 2026 11:32
Added publishing details for Azure Static Web Apps
Replace the inline Azure Static Web Apps walkthrough with a concise
"Other" section pointing to external Zensical guides for GitHub and
Azure DevOps deployments.

Made-with: Cursor
Signed-off-by: barcar <barcar@users.noreply.github.com>
@squidfunk squidfunk requested a review from alexvoss March 30, 2026 08:41
Copy link
Copy Markdown
Member

@alexvoss alexvoss left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@barcar - thanks for initiating this.

## Other

We cannot document every hosting provider here. The following community guides
describe how to deploy a Zensical site elsewhere:
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would like this to be more explicit, stating that we do not maintain these guides and that if people find issues they should contact the respective maintainers. How about:

"...site elsewhere. If you find an issue with one of these guides, please contact the author."

This loses the colon just before the list but I think that is ok.

We cannot document every hosting provider here. The following community guides
describe how to deploy a Zensical site elsewhere:

* [Azure Static Web Apps with GitHub](https://zensical-guides.hypercat.net/azure-static-web-app-github/)
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should this be "GitHub Actions", so it is clear what the "GitHub" part does here?

describe how to deploy a Zensical site elsewhere:

* [Azure Static Web Apps with GitHub](https://zensical-guides.hypercat.net/azure-static-web-app-github/)
* [Azure Static Web Apps with Azure DevOps](https://zensical-guides.hypercat.net/azure-static-web-app-devops/)
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Would it help us to have links to the issue tracker here - or should there be a link in the guide itself? I know the repository is linked in the header but a note on reporting issues in the right place might still be a good idea.

We could make a policy decision that we only link to guides that clearly indicate where issues should be reported. This may seem like a relatively minor issue but I think we save ourselves a lot of trouble if we are as clear about it as possible.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants